Refactor doc to restructure and improve #1943#2257
Merged
Conversation
pombredanne
changed the title
TG1999
reviewed
Apr 30, 2026
| - :ref:`misc` | ||
| - :ref:`soc_gsoc21` | ||
|
|
||
| .. include:: improve-docs.rst |
Contributor
There was a problem hiding this comment.
We don't have this rst file yet.
Contributor
|
@DennisClark we have some errors while building docs, we need a toctree. Also there are few files where we need to add a title. Thanks! |
Contributor
|
@DennisClark you can add a toctree like this And add title in file which are missing title like this Also verify errors with |
Member
Author
|
@TG1999 looks like you've got the solution all figured out! Please go ahead with the change if you have time, thanks. |
Signed-off-by: Tushar Goel <tushar.goel.dav@gmail.com>
Signed-off-by: Tushar Goel <tushar.goel.dav@gmail.com>
github-project-automation
Bot
moved this from In progress
to Done
in 00-AboutCodePlanner
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR is for:
@TG1999 and @keshav-space I have done the basic restructuring to format the rtd index to be consistent with
https://github.com/aboutcode-org/scancode.io/blob/main/docs/index.rst
Can you please check it over for syntax, etc.
The revised index.rst also points to these files, which I copied to docs/source (but have not removed them from the main level yet):
PIPELINES-AVID.rst
SOURCES.rst
api_v3_usage.rst
We'll probably want to add some explanatory text for the first two to give them some context; this is still a work-in-progress.